home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / editors / emacs / xemacs / xemacs-1.006 / xemacs-1 / lib / xemacs-19.13 / info / gnus.info-2 < prev    next >
Encoding:
GNU Info File  |  1995-09-01  |  33.8 KB  |  959 lines
  1. This is Info file ../info/gnus.info, produced by Makeinfo-1.55 from the
  2. input file gnus.texinfo.
  3.  
  4.    This file documents GNUS, the GNU Emacs newsreader.
  5.  
  6.    Copyright (C) 1989 Fujitsu Laboratories LTD.  Copyright (C) 1990
  7. Masanobu UMEDA.
  8.  
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.  
  13.    Permission is granted to copy and distribute modified versions of
  14. this manual under the conditions for verbatim copying, provided also
  15. that the sections entitled "Distribution" and "GNUS General Public
  16. License" are included exactly as in the original, and provided that the
  17. entire resulting derived work is distributed under the terms of a
  18. permission notice identical to this one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that the sections entitled "Distribution" and "GNUS
  23. General Public License" may be included in a translation approved by
  24. the author instead of in the original English.
  25.  
  26. 
  27. File: gnus.info,  Node: Moving Among Articles,  Next: Scrolling,  Prev: Browsing Headers,  Up: Reading Articles
  28.  
  29. Moving Among Articles
  30. ---------------------
  31.  
  32.    The commands described here are for moving the point on headers, and
  33. then automatically selecting articles.
  34.  
  35. `n'
  36.      Read the next article, skipping marked articles
  37.      (`gnus-Subject-next-unread-article').
  38.  
  39. `p'
  40.      Read the previous article, skipping marked articles
  41.      (`gnus-Subject-prev-unread-article').
  42.  
  43. `N'
  44.      Read the next article (`gnus-Subject-next-article').
  45.  
  46. `P'
  47.      Read the previous article (`gnus-Subject-prev-article').
  48.  
  49. `M-C-n'
  50.      Read the next article with the same subject as the current article
  51.      (`gnus-Subject-next-same-subject').
  52.  
  53. `M-C-p'
  54.      Read the previous article with the same subject as the current
  55.      article (`gnus-Subject-prev-same-subject').
  56.  
  57. `M-x gnus-Subject-next-unread-same-subject'
  58.      Read the next article with the same subject as the current article,
  59.      skipping marked articles.
  60.  
  61. `M-x gnus-Subject-prev-unread-same-subject'
  62.      Read the previous article with the same subject as the current
  63.      article, skipping marked articles.
  64.  
  65. `.'
  66.      Read the first unread article
  67.      (`gnus-Subject-first-unread-article').
  68.  
  69. `l'
  70.      Read the article selected last (`gnus-Subject-goto-last-article').
  71.  
  72. `J NUMBER RET'
  73.      Read the article specified by the article NUMBER
  74.      (`gnus-Subject-goto-article').
  75.  
  76.    If the variable `gnus-auto-select-same' is non-`nil', the commands
  77. `n' and `p' (`gnus-Subject-next-unread-article' and
  78. `gnus-Subject-prev-unread-article') move the point to unread articles
  79. with the same subject as the current article like the commands `M-x
  80. gnus-Subject-next-unread-same-subject' and `M-x
  81. gnus-Subject-prev-unread-same-subject', respectively.  If you are used
  82. to running `rn -S', set the variable to non-`nil'.
  83.  
  84.    If the variable `gnus-auto-extend-newsgroup' is non-`nil', the
  85. commands `N' and `P' (`gnus-Subject-next-article' and
  86. `gnus-Subject-prev-article') extend visible articles to forward and
  87. backward if possible.
  88.  
  89.    The variable `gnus-auto-select-next' defines the behavior of GNUS
  90. when there is no unread article in the current newsgroup and a command
  91. selecting the next unread article is executed.  If the variable is
  92. non-`nil', the next newsgroup containing unread articles is selected
  93. automatically.
  94.  
  95.    *Note Variables::, for more information on customization.
  96.  
  97. 
  98. File: gnus.info,  Node: Scrolling,  Next: Marking Articles,  Prev: Moving Among Articles,  Up: Reading Articles
  99.  
  100. Scrolling Within an Article
  101. ---------------------------
  102.  
  103.    Type `SPC' (`gnus-Subject-next-page') to scroll to the next page of
  104. the current article.  If no article is selected yet, an article near
  105. the point is selected and its first page is displayed in the Article
  106. buffer.  The next unread article is selected automatically if `SPC' is
  107. typed at the end of the message.
  108.  
  109. `SPC'
  110.      Scroll to the next page of the current article
  111.      (`gnus-Subject-next-page').  Select it first if no article is
  112.      selected yet.  Select the next unread article automatically at the
  113.      end of the message.
  114.  
  115. `DEL'
  116.      Scroll to the previous page of the current article
  117.      (`gnus-Subject-prev-page').
  118.  
  119. `RET'
  120.      Scroll up or down one line of the current article
  121.      (`gnus-Subject-scroll-up').
  122.  
  123. `<'
  124.      Move point to the beginning of the current article
  125.      (`gnus-Subject-beginning-of-article').
  126.  
  127. `>'
  128.      Move point to the end of the current article
  129.      (`gnus-Subject-end-of-article').
  130.  
  131. `w'
  132.      Stop page breaking (`gnus-Subject-stop-page-breaking').
  133.  
  134. `v'
  135.      Show all headers of the current article
  136.      (`gnus-Subject-show-all-headers').
  137.  
  138. `t'
  139.      Show all headers of the current article if pruned header currently
  140.      shown, or vice versa (`gnus-Subject-toggle-header').
  141.  
  142. `C-c C-r'
  143.      Caesar rotate letters by 13 places and Japanese characters by 47
  144.      places (`gnus-Subject-caesar-message').
  145.  
  146. `g'
  147.      Force to read the current article again
  148.      (`gnus-Subject-show-article').
  149.  
  150.    If the Article buffer is not visible, it is popped up under the
  151. Subject buffer when necessary.  The height of the Subject buffer and
  152. that of the Article buffer can be customized by using the variable
  153. `gnus-window-configuration'.
  154.  
  155.    The command `C-c C-r' (`gnus-Subject-caesar-message') rotates all
  156. letters in the message body of the current article by 13 places.
  157. Japanese characters are rotated by 47 places.  Running the command twice
  158. on the same article results the original message.
  159.  
  160.    If the variable `gnus-break-pages' is non-`nil', the message is
  161. broken into pages at page delimiters specified by the variable
  162. `gnus-page-delimiter'.  The command `w'
  163. (`gnus-Subject-stop-page-breaking') temporary suspends page breaks.
  164.  
  165.    The variable `gnus-ignored-headers' specifies header fields which
  166. should be ignored.  The command `v' (`gnus-Subject-show-all-headers')
  167. shows all headers of the current article, while the command `t'
  168. (`gnus-Subject-toggle-header') toggles the headers.
  169.  
  170.    *Note Variables::, and *note Hooks::., for more information on
  171. customization.
  172.  
  173. 
  174. File: gnus.info,  Node: Marking Articles,  Next: Thread-based Reading,  Prev: Scrolling,  Up: Reading Articles
  175.  
  176. Marking Articles
  177. ----------------
  178.  
  179.    GNUS uses three kinds of marks to indicate article status.
  180.  
  181.    * White space ` ' for newly arrived articles.
  182.  
  183.    * Dash `-' for articles marked as unread.
  184.  
  185.    * Any other characters for articles marked as read.
  186.  
  187.    The status is displayed at the beginning of each line of the Subject
  188. buffer.  Commands for marking or removing these marks are as follows:
  189.  
  190. `d'
  191.      Mark article as read, and then move to the next subject
  192.      (`gnus-Subject-mark-as-read-forward').
  193.  
  194. `D'
  195.      Mark article as read, and then move to the previous subject
  196.      (`gnus-Subject-mark-as-read-backward').
  197.  
  198. `u'
  199.      Mark article as unread, and then move to the next subject
  200.      (`gnus-Subject-mark-as-unread-forward').
  201.  
  202. `U'
  203.      Mark article as unread, and then move to the previous subject
  204.      (`gnus-Subject-mark-as-unread-backward').
  205.  
  206. `M-u'
  207.      Clear marks, and then move to the next subject
  208.      (`gnus-Subject-clear-mark-forward').
  209.  
  210. `M-U'
  211.      Clear marks, and then move to the previous subject
  212.      (`gnus-Subject-clear-mark-backward').
  213.  
  214. `k'
  215.      Mark articles with the same subject as the current article as
  216.      read, and then select the next unread article
  217.      (`gnus-Subject-kill-same-subject-and-select').
  218.  
  219. `C-k'
  220.      Mark articles with the same subject as the current article as read
  221.      (`gnus-Subject-kill-same-subject').
  222.  
  223. `c'
  224. `M-x gnus-Subject-catch-up-and-exit'
  225.      Mark all articles, which are not marked as unread, as read, and
  226.      then exit the current newsgroup.
  227.  
  228. `M-x gnus-Subject-catch-up-all-and-exit'
  229.      Mark all articles as read, and then exit the current newsgroup.
  230.  
  231. `M-x gnus-Subject-catch-up'
  232.      Mark all articles as read, preserving articles marked as unread.
  233.  
  234. `M-x gnus-Subject-catch-up-all'
  235.      Mark all articles as read.
  236.  
  237.    It is helpful to delete headers marked as read while reading a large
  238. newsgroup.  The command `x' (`gnus-Subject-delete-marked-as-read')
  239. deletes headers marked as read.  The command `X'
  240. (`gnus-Subject-delete-marked-with') deletes headers which have a
  241. specific mark.
  242.  
  243. `x'
  244.      Delete headers marked as read
  245.      (`gnus-Subject-delete-marked-as-read').
  246.  
  247. `X MARK RET'
  248.      Delete headers marked with MARK
  249.      (`gnus-Subject-delete-marked-with').
  250.  
  251. 
  252. File: gnus.info,  Node: Thread-based Reading,  Next: Digest Articles,  Prev: Marking Articles,  Up: Reading Articles
  253.  
  254. Reading Based on Conversation Threads
  255. -------------------------------------
  256.  
  257.    Conversations on the usenet news usually contain several threads
  258. under a single subject.  This makes it difficult to know which article
  259. follows which without reading references directly.  It would be useful
  260. if we could read articles based on conversation threads.
  261.  
  262.    GNUS enables you this thread-based reading.  The reader can follow
  263. threads of conversation, mark threads as read, and go up and down thread
  264. trees.  The command `M-C-t' (`gnus-Subject-toggle-threads') toggles
  265. showing conversation threads in Subject Mode.  If it is turned on,
  266. Subject buffer is displayed in a tree structured form according to what
  267. each article was a reply to.
  268.  
  269. `M-C-t'
  270.      Toggle thread-based reading (`gnus-Subject-toggle-threads').
  271.  
  272. `M-C-s'
  273.      Show thread subtrees (`gnus-Subject-show-thread').
  274.  
  275. `M-x gnus-Subject-show-all-threads'
  276.      Show all thread subtrees.
  277.  
  278. `M-C-h'
  279.      Hide thread subtrees (`gnus-Subject-hide-thread').
  280.  
  281. `M-x gnus-Subject-hide-all-threads'
  282.      Hide all thread subtrees.
  283.  
  284. `M-C-f'
  285.      Go to the same level next thread (`gnus-Subject-next-thread').
  286.  
  287. `M-C-b'
  288.      Go to the same level previous thread (`gnus-Subject-prev-thread').
  289.  
  290. `M-C-d'
  291.      Go down to the lower level thread (`gnus-Subject-down-thread').
  292.  
  293. `M-C-u'
  294.      Go up to the upper level thread (`gnus-Subject-up-thread').
  295.  
  296. `M-C-k'
  297.      Mark articles under current thread as read
  298.      (`gnus-Subject-kill-thread').
  299.  
  300.    Thread subtrees can be hidden by using the command `M-C-h'
  301. (`gnus-Subject-hide-thread'), and the hidden subtrees can be shown by
  302. using the command `M-C-s' (`gnus-Subject-show-thread').
  303.  
  304.    If the variable `gnus-thread-hide-killed' is non-`nil', thread
  305. subtrees killed by the command `M-C-k' (`gnus-Subject-kill-thread') are
  306. hidden automatically.
  307.  
  308.    If you want to hide thread subtrees initially, set the variable
  309. `gnus-thread-hide-subtree' to non-`nil'.
  310.  
  311.    If you want to enable thread-based reading automatically, set the
  312. variable `gnus-show-threads' to non-`nil'.
  313.  
  314.    *Note Variables::, for more information on customization.
  315.  
  316. 
  317. File: gnus.info,  Node: Digest Articles,  Prev: Thread-based Reading,  Up: Reading Articles
  318.  
  319. Reading Digest Articles
  320. -----------------------
  321.  
  322.    "Digest article" is a message containing many messages in "digest"
  323. format.  Since a digest article contains many messages in one article,
  324. it is a little bit difficult to read it on a per message basis.  The
  325. following commands make it easier to read each message in a digest.
  326.  
  327. `C-c C-n'
  328.      Scroll to the next digest message of the current article
  329.      (`gnus-Subject-next-digest').
  330.  
  331. `C-c C-p'
  332.      Scroll to the previous digest message of the current article
  333.      (`gnus-Subject-prev-digest').
  334.  
  335. `C-d'
  336.      Read the current digest article using Rmail
  337.      (`gnus-Subject-rmail-digest').
  338.  
  339.    The commands `C-c C-n' and `C-c C-p' (`gnus-Subject-next-digest' and
  340. `gnus-Subject-prev-digest') scroll a digest article to the next and
  341. previous digested message, respectively.  The variable
  342. `gnus-digest-separator' specifies a regexp which separates digested
  343. messages.
  344.  
  345.    The command `C-d' (`gnus-Subject-rmail-digest') runs Rmail on a
  346. digest article and makes it possible to read messages not in digest
  347. form using Rmail Mode.  *note Rmail: (emacs)Rmail, for more information
  348. on Rmail Mode.  Use the hook `gnus-Select-article-hook' to run Rmail on
  349. digest articles automatically.
  350.  
  351.    Digest articles in some newsgroups of USENET cannot be read using
  352. Rmail.  In this case, a message `Article is not a digest' is displayed
  353. in the echo area of Emacs.  This means that these articles are not
  354. written in the proper digest format.  It is, however, possible to read
  355. these incomplete digest articles by modifying the message headers or
  356. bodies appropriately using the hook `gnus-Select-digest-hook'.  *Note
  357. Hooks::, to modify incomplete digest articles.
  358.  
  359.    If the variable `gnus-digest-show-summary' is non-`nil', a summary
  360. of the digest article is also displayed automatically when Rmail is
  361. invoked.
  362.  
  363. 
  364. File: gnus.info,  Node: Searching Articles,  Next: Referencing Articles,  Prev: Reading Articles,  Up: Subject Commands
  365.  
  366. Searching Articles
  367. ==================
  368.  
  369. `s'
  370.      Do incremental search on the current article
  371.      (`gnus-Subject-isearch-article').
  372.  
  373. `M-s REGEXP RET'
  374.      Search for articles containing a match for REGEXP forward
  375.      (`gnus-Subject-search-article-forward').  If REGEXP is empty, the
  376.      last regexp used is used again.
  377.  
  378. `M-S REGEXP RET'
  379.      Search for articles containing a match for REGEXP backward
  380.      (`gnus-Subject-search-article-backward').  If REGEXP is empty, the
  381.      last regexp used is used again.
  382.  
  383. `& FIELD RET REGEXP RET COMMAND RET'
  384.      Execute COMMAND on articles containing a match for REGEXP in FIELD
  385.      of the headers (`gnus-Subject-execute-command').  If FIELD is
  386.      empty, the entire article is searched for.
  387.  
  388.    The command `s' (`gnus-Subject-isearch-article') does an incremental
  389. search on the current article.  The commands `M-s' and `M-S'
  390. (`gnus-Subject-search-article-forward' and
  391. `gnus-Subject-search-article-backward') search for articles containing
  392. a match for regexp.  The search starts from the current point of the
  393. current article.
  394.  
  395.    The command `&' (`gnus-Subject-execute-command') interactively reads
  396. the field name of article headers, regexp, and a valid command key
  397. sequence.  It then searches for articles having a field that contains a
  398. match for the regexp, and then executes the command specified by the
  399. key sequence on them.
  400.  
  401. 
  402. File: gnus.info,  Node: Referencing Articles,  Next: Saving Articles,  Prev: Searching Articles,  Up: Subject Commands
  403.  
  404. Referencing Articles
  405. ====================
  406.  
  407. `^'
  408.      Refer to parent of the current article
  409.      (`gnus-Subject-refer-parent-article').  With a prefix argument, go
  410.      back to the child.
  411.  
  412. `M-r MESSAGE-ID RET'
  413.      Refer to the article by using the MESSAGE-ID
  414.      (`gnus-Subject-refer-article').  With an empty MESSAGE-ID, go back
  415.      to the origin.
  416.  
  417.    The command `^' (`gnus-Subject-refer-parent-article') refers to
  418. parent article of the current article.  The child article is remembered
  419. in internal history, and it is possible to return to the child by
  420. giving a prefix argument to the command.
  421.  
  422.    The commands `^' and `M-r' (`gnus-Subject-refer-parent-article' and
  423. `gnus-Subject-refer-article') share the same internal history.  You can
  424. thus go back to a child using the command `M-r' with an empty
  425. Message-ID.
  426.  
  427.    Type `g' (`gnus-Subject-show-article') to go back to the origin from
  428. the visited articles directly.
  429.  
  430.    *Note Article Commands::, to refer to articles by using Message-IDs
  431. included in the messages.
  432.  
  433. 
  434. File: gnus.info,  Node: Saving Articles,  Next: Sorting Headers,  Prev: Referencing Articles,  Up: Subject Commands
  435.  
  436. Saving Articles
  437. ===============
  438.  
  439.    GNUS provides four different formats for saving articles: Rmail
  440. format, Unix mailbox format, MH folder, and article format.  If you set
  441. the variable `gnus-default-article-saver' to your favorite article
  442. saver, you can save an article using the command `o'
  443. (`gnus-Subject-save-article') in your favorite format.  The default
  444. saver is the function `gnus-Subject-save-in-rmail'.
  445.  
  446. `o'
  447.      Save the current article using the default saver specified by the
  448.      variable `gnus-default-article-saver'
  449.      (`gnus-Subject-save-article').
  450.  
  451. `C-o'
  452. `M-x gnus-Subject-save-in-mail'
  453.      Save the current article in Unix mailbox format.
  454.  
  455. `M-x gnus-Subject-save-in-rmail'
  456.      Save the current article in Rmail format.
  457.  
  458. `M-x gnus-Subject-save-in-folder'
  459.      Save the current article in an MH folder.
  460.  
  461. `M-x gnus-Subject-save-in-file'
  462.      Save the current article in article format.
  463.  
  464. `| COMMAND RET'
  465.      Send contents of the current article to the COMMAND subprocess
  466.      (`gnus-Subject-pipe-output').
  467.  
  468.    If the variable `gnus-save-all-headers' is non-`nil', all headers of
  469. an article are saved.
  470.  
  471.    The variable `gnus-article-save-directory' specifies a directory in
  472. which articles are saved to by the functions
  473. `gnus-Subject-save-in-mail', `gnus-Subject-save-in-rmail', and
  474. `gnus-Subject-save-in-file'.  It is initialized from the `SAVEDIR'
  475. environment variable.  The default directory is `~/News'.
  476.  
  477.    The variables `gnus-mail-save-name', `gnus-rmail-save-name',
  478. `gnus-folder-save-name', and `gnus-file-save-name' specify functions
  479. generating default file name to which articles are saved using
  480. `gnus-Subject-save-in-mail', `gnus-Subject-save-in-rmail',
  481. `gnus-Subject-save-in-folder', and `gnus-Subject-save-in-file',
  482. respectively.  The function is called with NEWSGROUP, HEADERS, and
  483. optional LAST-NAME.
  484.  
  485.    *Note Variables::, for more information on customization.
  486.  
  487. 
  488. File: gnus.info,  Node: Sorting Headers,  Next: Followup and Reply,  Prev: Saving Articles,  Up: Subject Commands
  489.  
  490. Sorting Headers
  491. ===============
  492.  
  493.    The headers listed in the Subject buffer can be sorted by number,
  494. subject, date, or author of articles.  Sorting is stable, so it is
  495. possible to combine them to sort the headers with multiple keys.  To
  496. sort in reverse order, give a prefix argument to the commands.
  497.  
  498. `C-c C-s n'
  499. `C-c C-s C-n'
  500.      Sort the headers by number (`gnus-Subject-sort-by-number').
  501.  
  502. `C-c C-s s'
  503. `C-c C-s C-s'
  504.      Sort the headers by subject (`gnus-Subject-sort-by-subject').
  505.  
  506. `C-c C-s d'
  507. `C-c C-s C-d'
  508.      Sort the headers by date (`gnus-Subject-sort-by-date').
  509.  
  510. `C-c C-s a'
  511. `C-c C-s C-a'
  512.      Sort the headers by author (`gnus-Subject-sort-by-author').
  513.  
  514.    It is also possible to sort the headers automatically when a
  515. newsgroup is selected using the hook `gnus-Select-group-hook' (*note
  516. Hooks::.).
  517.  
  518. 
  519. File: gnus.info,  Node: Followup and Reply,  Next: Exiting Newsgroup,  Prev: Sorting Headers,  Up: Subject Commands
  520.  
  521. Followup and Reply
  522. ==================
  523.  
  524. `f'
  525.      Followup to the current article (`gnus-Subject-post-reply').
  526.  
  527. `F'
  528.      Followup to the current article with the original article
  529.      (`gnus-Subject-post-reply-with-original').
  530.  
  531. `a'
  532.      Compose a new article (`gnus-Subject-post-news').
  533.  
  534.    Type `a' (`gnus-Subject-post-news') to post a new article.  If the
  535. variable `gnus-interactive-post' is non-`nil', the newsgroup, subject,
  536. and distribution are asked for interactively.  The command `f'
  537. (`gnus-Subject-post-reply') fills these values in automatically from
  538. those of the original article.  Type `C-c C-y'
  539. (`news-reply-yank-original') to include the original article.  The
  540. command `F' (`gnus-Subject-post-reply-with-original') yanks the
  541. original article automatically.  If you want to followup to several
  542. articles in a single article and want to include them in it, type `F'
  543. for each of them.  You will be asked if a text being edited should be
  544. erased.  You should answer `n' to the question.
  545.  
  546.    If the variable `gnus-novice-user' is non-`nil', your confirmations
  547. will be required for composing a new article.
  548.  
  549.    The major mode for composing a new article is "News Mode" which is
  550. borrowed from `rnewspost.el'.  Type `C-h m' (`describe-mode') to get
  551. more help on News Mode.
  552.  
  553. `C'
  554.      Cancel the current article you posted
  555.      (`gnus-Subject-cancel-article').
  556.  
  557.    Suppose you post an article and then later realize that you made a
  558. horrible mistake.  You really do not want anyone to see your article.
  559. You want the article to be removed from any machines that it may have
  560. reached.  The command `C' (`gnus-Subject-cancel-article') is intended
  561. to do this.  First select the offending article as current, then type
  562. `C'.
  563.  
  564. `r'
  565.      Reply to the author of the current article
  566.      (`gnus-Subject-mail-reply').
  567.  
  568. `R'
  569.      Reply to the author of the current article with the original
  570.      article (`gnus-Subject-mail-reply-with-original').
  571.  
  572. `C-c C-f'
  573.      Forward the current message to another user.
  574.      (`gnus-Subject-mail-forward').
  575.  
  576. `m'
  577.      Compose a mail message in other window
  578.      (`gnus-Subject-mail-other-window').
  579.  
  580.    Use the command `r' (`gnus-Subject-mail-reply') to reply to the
  581. author of the article.  Type `C-c C-y' to include the original article.
  582. The command `R' (`gnus-Subject-mail-reply-with-original') yanks the
  583. original article automatically.
  584.  
  585.    When composing a mail message, the message composer (or mailer) is
  586. selected by the values of the variables `gnus-mail-reply-method',
  587. `gnus-mail-forward-method', and `gnus-mail-other-window-method'.  These
  588. are defaulted to use Mail Mode.  If you want to use mh-e letter Mode
  589. instead of it, set the variable `gnus-mail-reply-method' to
  590. `gnus-mail-reply-using-mhe', variable `gnus-mail-forward-method' to
  591. `gnus-mail-forward-using-mhe', and the variable
  592. `gnus-mail-other-window-method' to `gnus-mail-other-window-using-mhe'.
  593. It is possible to use other mailers by customizing these variables.
  594. *note Mail Mode: (emacs)Mail Mode, for more information on Mail Mode.
  595.  
  596. 
  597. File: gnus.info,  Node: Exiting Newsgroup,  Next: Other Subject Commands,  Prev: Followup and Reply,  Up: Subject Commands
  598.  
  599. Exiting the Current Newsgroup
  600. =============================
  601.  
  602. `q'
  603.      Exit the current newsgroup, and return to Group Mode
  604.      (`gnus-Subject-exit').
  605.  
  606. `Q'
  607.      Exit the current newsgroup without recording unread articles
  608.      information (`gnus-Subject-quit').
  609.  
  610. `c'
  611. `M-x gnus-Subject-catch-up-and-exit'
  612.      Mark all articles, which are not marked as unread, as read, then
  613.      exit the current newsgroup.
  614.  
  615. `M-x gnus-Subject-catch-up-all-and-exit'
  616.      Mark all articles as read, then exit the current newsgroup.
  617.  
  618. `G'
  619.      Record unread articles information, then reselect the current
  620.      newsgroup (`gnus-Subject-reselect-current-group').
  621.  
  622. `M-x gnus-Subject-next-group'
  623.      Record unread articles information, then select the next newsgroup
  624.      containing unread articles.
  625.  
  626. `M-x gnus-Subject-prev-group'
  627.      Record unread articles information, then select the previous
  628.      newsgroup containing unread articles.
  629.  
  630.    The command `G' (`gnus-Subject-reselect-current-group') selects the
  631. current newsgroup again after temporary exiting the newsgroup.  If no
  632. articles remain unread, all articles in the newsgroup will be selected.
  633. A prefix argument to the command means to select all articles in the
  634. newsgroup.
  635.  
  636. 
  637. File: gnus.info,  Node: Other Subject Commands,  Prev: Exiting Newsgroup,  Up: Subject Commands
  638.  
  639. Miscellaneous Commands
  640. ======================
  641.  
  642.    Other miscellaneous commands are described here.
  643.  
  644. `M-k'
  645.      Edit a local KILL file applied to the current newsgroup
  646.      (`gnus-Subject-edit-local-kill').  *Note KILL File::, for more
  647.      information.
  648.  
  649. `M-K'
  650.      Edit a global KILL file applied to all newsgroups
  651.      (`gnus-Subject-edit-local-kill').  *Note KILL File::, for more
  652.      information.
  653.  
  654. `V'
  655.      Print the version number of this GNUS (`gnus-version').
  656.  
  657. `?'
  658.      Describe Subject Mode commands briefly
  659.      (`gnus-Subject-describe-briefly').
  660.  
  661. `C-c C-i'
  662.      Read Info on Subject Mode (`gnus-Info-find-node').  *Note Texinfo
  663.      Manual::, to prepare an Info file of GNUS.
  664.  
  665. 
  666. File: gnus.info,  Node: Article Commands,  Next: KILL File,  Prev: Subject Commands,  Up: Top
  667.  
  668. Article Commands
  669. ****************
  670.  
  671.    In the Article buffer the following commands are available:
  672.  
  673. `SPC'
  674.      Scroll text of the current window (`gnus-Article-next-page').
  675.  
  676. `DEL'
  677.      Scroll text of the current window (`gnus-Article-prev-page').
  678.  
  679. `r'
  680.      Refer to article specified by the Message-ID close to the point
  681.      (`gnus-Article-refer-article').
  682.  
  683. `o'
  684.      Return to the previous article from the referenced article
  685.      (`gnus-Article-pop-article').
  686.  
  687. `h'
  688. `s'
  689.      Reconfigure Emacs windows to show the Subject buffer above the
  690.      Article buffer and move the point to the Subject buffer
  691.      (`gnus-Article-show-subjects').
  692.  
  693. `?'
  694.      Describe Article Mode commands briefly
  695.      (`gnus-Article-describe-briefly').
  696.  
  697. `C-c C-i'
  698.      Read Info on Article Mode (`gnus-Info-find-node').  *Note Texinfo
  699.      Manual::, to prepare an Info file of GNUS.
  700.  
  701.    The command `r' (`gnus-Article-refer-article') searches for the
  702. Message-ID around the point, and refers to the article specified by it
  703. if found.  Use the command `o' (`gnus-Article-pop-article') to return
  704. to the previous article.  *Note Referencing Articles::, for referencing
  705. parent articles easily.
  706.  
  707. 
  708. File: gnus.info,  Node: KILL File,  Next: Customization,  Prev: Article Commands,  Up: Top
  709.  
  710. KILL File
  711. *********
  712.  
  713.    The purpose of a KILL file and its usage are described here.
  714.  
  715. * Menu:
  716.  
  717. * What KILL Files Do::          An introduction to a KILL file.
  718. * Making a KILL File::          How to make a KILL file.
  719. * Editing KILL Files::          How to edit KILL files.
  720. * Example of a KILL File::      An example of a KILL file.
  721.  
  722. * Background Kills::            Background kill processing.
  723. * Advanced Kills::              Advanced kill processing.
  724.  
  725. 
  726. File: gnus.info,  Node: What KILL Files Do,  Next: Making a KILL File,  Prev: KILL File,  Up: KILL File
  727.  
  728. What KILL Files Do
  729. ==================
  730.  
  731.    A "KILL" file contains lisp expressions to be applied to a selected
  732. newsgroup.  The purpose is to mark articles as read on the basis of
  733. some set of regexps.
  734.  
  735.    There are two kinds of KILL files, global and local.  A global KILL
  736. file is applied to every newsgroup, and a local KILL file to a specified
  737. newsgroup.  Since a global KILL file is applied to every newsgroup, for
  738. better performance use a local one.
  739.  
  740. 
  741. File: gnus.info,  Node: Making a KILL File,  Next: Editing KILL Files,  Prev: What KILL Files Do,  Up: KILL File
  742.  
  743. Making a KILL File
  744. ==================
  745.  
  746.    A KILL file can contain any kind of Emacs lisp expressions expected
  747. to be evaluated in the Subject buffer.  Writing lisp programs for this
  748. purpose is not easy because the internal working of GNUS must be
  749. well-known.  For this reason, GNUS provides a general function which
  750. does this easily for non-lisp programmers.
  751.  
  752.      (gnus-kill FIELD REGEXP &optional COMMAND ALL)
  753.  
  754. The `gnus-kill' function executes commands available in Subject Mode by
  755. their key sequences.  `gnus-kill' must be called with FIELD, REGEXP,
  756. and optional COMMAND and ALL.  FIELD is a string representing the
  757. header field or an empty string.  If FIELD is an empty string, the
  758. entire article body is searched for.  REGEXP is a string which is
  759. compared with FIELD value.  COMMAND is a string representing a valid key
  760. sequence in Subject Mode or a lisp expression.  COMMAND is default to
  761. `(gnus-Subject-mark-as-read nil "X")'.  Make sure that COMMAND is
  762. executed in the Subject buffer.  If the second optional argument ALL is
  763. non-`nil', the COMMAND is applied to articles which are already marked
  764. as read or unread.  Articles which are marked are skipped over by
  765. default.
  766.  
  767.    For example, if you want to mark articles of which subjects contain
  768. the string `AI' as read, a possible KILL file may look like:
  769.  
  770.      (gnus-kill "Subject" "AI")
  771.  
  772.    If you want to mark articles with `D' instead of `X', you can use
  773. the following expression:
  774.  
  775.      (gnus-kill "Subject" "AI" "d")
  776.  
  777. In this example it is assumed that the command
  778. `gnus-Subject-mark-as-read-forward' is assigned to `d' in Subject Mode.
  779.  
  780.    It is possible to delete unnecessary headers which are marked with
  781. `X' in a KILL file by using the function `gnus-expunge' as follows:
  782.  
  783.      (gnus-expunge "X")
  784.  
  785.    If the Subject buffer is empty after applying KILL files, GNUS will
  786. exit the selected newsgroup normally.  If headers which are marked with
  787. `D' are deleted in a KILL file, it is impossible to read articles which
  788. are marked as read in the previous GNUS sessions.  Marks other than `D'
  789. should be used for articles which should really be deleted.
  790.  
  791.    All sorts of searches in Subject Mode normally ignore the case of the
  792. text they are searching through.  If you do not want to ignore the case,
  793. set the variable `case-fold-search' to `nil'.
  794.  
  795. 
  796. File: gnus.info,  Node: Editing KILL Files,  Next: Example of a KILL File,  Prev: Making a KILL File,  Up: KILL File
  797.  
  798. Editing KILL Files
  799. ==================
  800.  
  801.    The command `M-K' in Subject Mode and Group Mode
  802. (`gnus-Subject-edit-global-kill' and `gnus-Group-edit-global-kill')
  803. pops up an Emacs buffer for editing a global KILL file.  A global KILL
  804. file is created in the directory specified by the variable
  805. `gnus-article-save-directory' (default to `~/News'), and its file name
  806. is specified by the variable `gnus-kill-file-name' (default to `KILL').
  807.  
  808.    The command `M-k' in Subject Mode and Group Mode
  809. (`gnus-Subject-edit-local-kill' and `gnus-Group-edit-local-kill') pops
  810. up an Emacs buffer for editing a local KILL file.  A local KILL file
  811. for a newsgroup NEWS.GROUP is created as `NEWS.GROUP.KILL' in the
  812. directory specified by the variable `gnus-article-save-directory' if
  813. the variable `gnus-use-long-file-name' is non-`nil'.  Otherwise, if the
  814. variable `gnus-use-long-file-name' is `nil', the file is created as
  815. `NEWS/GROUP/KILL' under the same directory.
  816.  
  817.    The major mode of these buffers is "KILL-File Mode".  This mode is
  818. specialized for editing Emacs lisp programs the same as Emacs-Lisp Mode.
  819. In addition to Emacs-Lisp Mode, the following commands are available:
  820.  
  821. `C-c C-k C-s'
  822.      Insert a template of a kill command on subject
  823.      (`gnus-Kill-file-kill-by-subject').
  824.  
  825. `C-c C-k C-a'
  826.      Insert a template of a kill command on author
  827.      (`gnus-Kill-file-kill-by-author').
  828.  
  829. `C-c C-a'
  830.      Apply current buffer being edited to selected newsgroup
  831.      (`gnus-Kill-file-apply-buffer').
  832.  
  833. `C-c C-e'
  834.      Apply sexp before point in current buffer to selected newsgroup
  835.      (`gnus-Kill-file-apply-last-sexp').
  836.  
  837. `C-c C-c'
  838.      Save the KILL file and then return to the previous buffer
  839.      (`gnus-Kill-file-exit').
  840.  
  841. `C-c C-i'
  842.      Read Info on KILL file (`gnus-Info-find-node').  *Note Texinfo
  843.      Manual::, to prepare an Info file of GNUS.
  844.  
  845.    If KILL-File Mode is invoked from Subject Mode by the command
  846. `gnus-Subject-edit-local-kill' or `gnus-Subject-edit-global-kill', the
  847. commands `C-c C-k C-s' and `C-c C-k C-a'
  848. (`gnus-Kill-file-kill-by-subject' and `gnus-Kill-file-kill-by-author')
  849. insert a kill command on the subject and author of an article where the
  850. point is on, respectively.  Otherwise, a template of a kill command is
  851. inserted.
  852.  
  853.    The commands `C-c C-a' and `C-c C-e' (`gnus-Kill-file-apply-buffer'
  854. and `gnus-Kill-file-apply-last-sexp') can be used to test kill commands
  855. being edited in current buffer.  The kill commands are applied to
  856. current newsgroup.
  857.  
  858. 
  859. File: gnus.info,  Node: Example of a KILL File,  Next: Background Kills,  Prev: Editing KILL Files,  Up: KILL File
  860.  
  861. Example of a KILL File
  862. ======================
  863.  
  864.    The following is an example of a local KILL file for newsgroup
  865. `control'.  This is currently being used by the author.
  866.  
  867.      ;; Apply to the newsgroup `control' if the NNTP server is flab.
  868.      (if (string-equal gnus-nntp-server "flab")
  869.          (progn
  870.            (gnus-kill "Subject" "ihave flab\\|sendme")
  871.            (gnus-kill "Subject" "cancel\\|newgroup\\|rmgroup" "d")
  872.            (gnus-expunge "X")))
  873.  
  874. 
  875. File: gnus.info,  Node: Background Kills,  Next: Advanced Kills,  Prev: Example of a KILL File,  Up: KILL File
  876.  
  877. Background Kill Processing
  878. ==========================
  879.  
  880.    Kill processing may take long time.  If it becomes terribly
  881. frustrating, try background kill processing using the following shell
  882. command:
  883.  
  884.      emacs -batch -l gnus -f gnus-batch-kill NEWSGROUPS
  885.  
  886. where NEWSGROUPS argument is newsgroup names separated by either white
  887. spaces or a comma.  `!' preceding a newsgroup name means negation, and
  888. `all' matches anything else.  These interpretations are the same as the
  889. options line of the startup file (*note Startup File::.).
  890.  
  891. 
  892. File: gnus.info,  Node: Advanced Kills,  Prev: Background Kills,  Up: KILL File
  893.  
  894. Advanced Kill Processing
  895. ========================
  896.  
  897.    Internally, applying kills means to run the hook
  898. `gnus-Apply-kill-hook'.  It is called after the Subject buffer is
  899. prepared for a selected newsgroup.  The default hook is the function
  900. `gnus-apply-kill-file' which loads a global KILL file and a local KILL
  901. file in this order.  A different style of the kill processing can be
  902. implemented by customizing this hook.
  903.  
  904.    For example, if you think a global KILL file is unnecessary, you can
  905. use the following hook which applies only a local KILL file.  This
  906. change can save the time for checking the existence of a global KILL
  907. file.
  908.  
  909.      (setq gnus-Apply-kill-hook
  910.            (function
  911.             (lambda ()
  912.               ;; Apply a local KILL file.
  913.               (load (gnus-newsgroup-kill-file gnus-newsgroup-name) t nil t))))
  914.  
  915.    On the contrary, the following example enables only a global KILL
  916. file.
  917.  
  918.      (setq gnus-Apply-kill-hook
  919.            (function
  920.             (lambda ()
  921.               ;; Apply a global KILL file.
  922.               (load (gnus-newsgroup-kill-file nil) t nil t))))
  923.  
  924.    Here is an advanced example that drastically reduces the time for
  925. applying KILL files.  This hook does the kill processing directly
  926. without loading the KILL files.
  927.  
  928.      (setq gnus-Apply-kill-hook
  929.            (function
  930.             (lambda ()
  931.               ;; Apply to the newsgroup `control'
  932.               ;; if the NNTP server is flab.
  933.               (and (string-equal gnus-nntp-server "flab")
  934.                    (string-equal gnus-newsgroup-name "control")
  935.                    (progn
  936.                      (gnus-kill "Subject" "ihave flab\\|sendme")
  937.                      (gnus-kill "Subject" "cancel\\|newgroup\\|rmgroup" "d")
  938.                      (gnus-expunge "X"))))))
  939.  
  940. 
  941. File: gnus.info,  Node: Customization,  Next: Problems,  Prev: KILL File,  Up: Top
  942.  
  943. Customizing GNUS
  944. ****************
  945.  
  946.    Appendix A describes the variables and hooks for simple customization
  947. and the variables for localization.
  948.  
  949. * Menu:
  950.  
  951. * Variables::           Variables for customizing GNUS.
  952.  
  953. * NNTP Variables::      Variables for localizing NNTP environment.
  954. * Spool Variables::     Variables for localizing news spool environment.
  955. * Directory Variables:: Variables for localizing private directory environment.
  956.  
  957. * Hooks::               Function hooks for customizing GNUS.
  958.  
  959.